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1 Django Admin Cookbook - How to do things with Django admin. 


This is a book about doing things with Django admin. It takes the form of about forty questions and common tasks 
with Django admin we answer. 


The chapters are based on a common set of models, which you can read in detail here (Models used in this book). In 
short, we have two apps, events and entities. The models are 


* Events: Epic, Event, EventHero, EventVillian 


e Entities: Category, Origin, Hero, Villain 


1.1 Introduction 


Django Admin Cookbook is a book about doing things with Django admin. It is targeted towards intermediate Django 
developers, who have some experience with Django admin, but are looking to expand their knowledge of Django 
admin and achieve mastery of Django admin. 


It takes the form of question and answers about common tasks you might do with Django admin. All the chapters are 
based on a common set of models, which you can read in detail here (Models used in this book). In short, we have two 
apps, events and entities. The models are 


* Events: Epic, Event, EventHero, EventVillain 


e Entities: Category, Origin, Hero, Villain 


How to use this book 


You can read this book either from start to end, or search for the things you need to do and only read those chapters. 
Each chapter focusses on a single, specific task. 


In either case, you should read the entities/models.py and events/models.py first. 


2 Text and Design 


2.1 How to change ‘Django administration’ text? 
By default Django admin shows ‘Django administration’. You have been asked to replace this with 'UMSRA Admin- 
istration’ 
The text is at these pages: 
* Login Page 
* The listview page 


* The HTML title tag 


Login, Listview and Changeview Page 


By default it looks like this and is setto "Django administration" 


Django administration 


Username: 


[{ 


Password: 


site_header can be set to change this. 


Listview Page 


BY default it looks like this and is set to “Site administration” 


Site administration 


AUTHENTICATION AND AUTHORIZATION 


Groups * Add # Change 
Users *Add # Change 
Categorys *Add # Change 
Heros * Add # Change 
Origins *Add # Change 
Villains * Add # Change 
Epics * Add # Change 
Event heros * Add # Change 
Event villains "Add # Change 
Events *Add # Change 


index title can be set to change this. 


HTML title tag 


By default it looks like this and is setto "Django site admin" 


Ì Site administration | Django si X \\ — 


site title can be set to change this. 


We can make the three changes in urls.py: 


admin.site.site_header = "UMSRA Admin" 
admin.site.site title = "UMSRA Admin Portal" 
admin.site.index_title = "Welcome to UMSRA Researcher Portal" 


2.2 How to set the plural text for a model? 


By default admin will show the name of your model appended with an “s”, aka the plural form of your model. It looks 
like this 


Welcome to UMSRA Researcher Portal 


AUTHENTICATION AND AUTHORIZATION 


Groups + Add # Change 
Users * Add # Change 
Categorys "Add # Change 
Heros * Add # Change 
Origins * Add # Change 
Villains * Add # Change 


You have been asked to set the correct plural spellings: Categories and Heroes 


You can do this by setting the verbose name plural in your models. Change that in your models.py.: 


class Category (models.Model): 


class Meta: 
verbose name plural = "Categories" 


class Hero(Entity): 


class Meta: 
verbose name plural - "Heroes" 


With the changes your Admin will look like this. 


Welcome to UMSRA Researcher Portal 


AUTHENTICATION AND AUTHORIZATION 


Groups + Add # Change 
Users + Add # Change 
Categories + Add # Change 
Heroes + Add # Change 
Origins * Add # Change 
Villains * Add # Change 


2.3 How to create two independent admin sites? 
The usual way to create admin pages is to put all models in a single admin. However it is possible to have multiple 
admin sites in a single Django app. 


Right now our entity and event models are in same place. UMSRA has two distinct group researching Events 
and Entities, and so wants to split the admins. 


We will keep the default admin for entities and create a new subclass of AdminSite for events. 


In our events/admin.py we do: 


from django.contrib.admin import AdminSite 
class EventAdminSite (AdminSite): 


site header = "UMSRA Events Admin" 

site title = "UMSRA Events Admin Portal" 

index title = "Welcome to UMSRA Researcher Events Portal" 
event admin site = EventAdminSite(name-'event admin!) 


event admin site.register (Epic) 

event admin site.register (Event) 

event admin site.register (EventHero) 
event admin site.register(EventVillain) 


And change the urls.py to 


from events.admin import event admin site 


(continues on next page) 


(continued from previous page) 


urlpatterns = [ 
path('entity-admin/', admin.site.urls), 
path('event-admin/', event_admin_site.urls), 


] 


This separates the admin. Both admins are available at their respective urls, /entity-admin/ and 
event-admin/. 


2.4 How to remove default apps from Django admin? 


Django will include django.contrib.authin INSTALLED APPS, which means User and Groups models are 
included in admin automatically. 


Welcome to UMSRA Researcher Portal 


AUTHENTICATION AND AUTHORIZATION 


Groups * Add # Change 
Users * Add # Change 
Categories * Add # Change 
Heroes * Add # Change 
Origins *Add # Change 
Villains * Add # Change 


If you want to remove it, you will have to unregister them. 


from django.contrib.auth.models import User, Group 


admin.site.unregister (User) 
admin.site.unregister (Group) 


After making these changes, your admin should look like this. 


Welcome to UMSRA Researcher Portal 


ENTITIES 


Categories * Add # Change 
Heroes * Add # Change 
Origins * Add # Change 
Villains * Add # Change 


2.5 How to add a logo to Django admin? 
Your higher ups at UMSRA love the admin you have created till now, but marketing wants to put the UMSRA logo on 
all admin pages. 


You need to override the default templates provided by Django. In your django settings, you code:: TEMPLATES 
setting looks like this. 


TEMPLATES = [ 
{ 
"BACKEND': 'django.template.backends.django.DjangoTemplates', 
DIRS 2 UT 
'APP DIRS': True, 


'OPTIONS': ( 
'context processors': [ 
'django.template.context processors.debug', 
'django.template.context processors.request', 
'django.contrib.auth.context processors.auth', 
'django.contrib.messages.context processors.messages', 
l; 
}, 
hy 


This means that Django will look for templates in a directory called templates inside each app, but you can override 
that by setting a value for TEMPLATES .DIRS. 


We change the 'DIRS': [], to 'DIRS': [os.path.join(BASE DIR, 'templates/')],, and create 
the templates folder. If your STATICFILES, DIRS is empty set it to: 


STATICFILES DIRS - [ 
os.path.join(BASE DIR, "static"), 


Now copy the base site.html from the admin app to templates admin folder you just created. Replace thre 
default text in branding block with: 


«hl id="site-name"> 
«a href="{% url 'admin:index' %}"> 
«img src-"($ static 'umsra logo.png' %}" height="40px" /» 


(continues on next page) 


(continued from previous page) 


«/a» 
«/h1» 


With the changes your base. site.html will look like this: 


$ extends "admin/base.html" %} 
% load staticfiles %} 


$ block title %}{{ title }} | {{ site title|default: ('Django site admin') }}{%,, 
—endblock %} 


9. 


$ block branding 5) 
«hl id="site-name"> 
«a href="{% url 'admin:index' %}"> 
«img src-"($ static 'umsra logo.png' %}" height="40px" /» 
«/a» 
«/h1» 
$5 endblock 4) 


($ block nav-global %}{% endblock $) 


And your admin will look like this 


Welcome to UMSRA Researcher Events Portal 


EVENTS 


Epics * Add # Change 
Event heros * Add # Change 
Event villains * Add # Change 
Events * Add # Change 


2.6 How to override Django admin templates? 


https://docs.djangoproject.com/en/dev/ref/contrib/admin/ftoverriding-admin-templates 


3 Calculated fields 


3.1 How to show calculated fields on listview page? 


You have an admin for the Origin model like this: 


@admin. register (Origin) 
class OriginAdmin (admin.ModelAdmin) : 
list display = ("name",) 


Apart from the name, we also want to show the number of heroes and number of villains for each origin, which is not 
a DB field on Origin. You can do this in two ways. 


Adding a method to the model 


You can add two methods to your Origin model like this: 


def hero count (self,): 
return self.hero set.count() 


def villain count (self): 
return self.villain set.count() 


And change list displaytolist display = ("name", "hero count", "villain count"). 


Adding a method to the ModelAdmin 


If you don't want to add method to the model, you can do instead add the method to the ModelAdmin. 


def hero count(self, obj): 
return obj.hero set.count() 


def villain count(self, obj): 
return obj.villain set.count() 


The list display, as earlier, changes to list display = ("name", "hero count", 
"villain count"). 


Performance considerations for calculated fields 


With either of the above approaches, you would be running two exta queries per object (One per calculated field). You 
can find how to optimize this in How to optimize queries in Django admin?. 


With any of these changes your admin looks like this: 


UMSRA «i WELCOME, SHABDA 


Home > Entities > Origins 


Select origin to change 


Action: | --------- 4|| Go | 0 of 3 selected 

[] NAME HERO COUNT VILLAIN COUNT 
O Norse 0 0 

O Greece 1 0 

© India 2 1 

3 origins 


3.2 How to optimize queries in Django admin? 


If you have a lot of calculated fields in your admin, you can be running multiple queries per object leading to your 
admin can becoming quite slow. To fix this you can override the get_queryset method on model admin to annotate 
the calculated fields. 


Lets take the example of this ModelAdmin we have for Origin: 


@admin. register (Origin) 
class OriginAdmin (admin.ModelAdmin) : 
list_display = ("name", "hero_count", "villain_count") 


def hero_count (self, obj): 
return obj.hero_set.count () 


def villain_count (self, obj): 
return obj.villain set.count() 


This adds two extra queries per row in your listview page. To fix this you can override the get. queryset to 
annotate the counted fields, and then use the annotated fields in your ModelAdmin methods. 


With the changes, your ModelAdmin field looks like this: 


@admin. register (Origin) 
class OriginAdmin (admin.ModelAdmin) : 
list_display = ("name", "hero_count", "villain_count") 


def get_queryset (self, request): 
queryset = super().get queryset (request) 
queryset = queryset.annotate ( 
hero count-Count("hero", distinct=True) , 
villain count-Count("villain", distinct-True), 


) 


return queryset 


(continues on next page) 


(continued from previous page) 


def hero_count (self, obj): 
return obj._hero_count 


def villain count(self, obj): 
return obj. villain count 


There are no per object extra queries. Your admin continues to look like it did before the annotate call. 


UMSRA A WELCOME, SHABDA 


Home > Entities » Origins 


Select origin to change 


Action: | --------- *$|| Go | 0of3 selected 

m NAME HERO COUNT VILLAIN COUNT 
O Norse 0 0 

O Greece 1 0 

O India 2 1 

3 origins 


3.3 How to enable sorting on calculated fields? 
Django adds sorting capabilities on fields which are attributes on the models. When you add a calculated field Django 
doesn’t know how to do a order_by, so it doesn’t add sorting capability on that field. 


If you want to add sorting on a calculated field, you have to tell Django what to pass to order_by. You can do this 
by setting the admin_order_field attribute on the calculated field method. 


You start from the admin you wrote in the previous chapter (How to optimize queries in Django admin?).: 


hero count.admin order field = ' hero count' 
villain count.admin order field - ' villain count' 


With these changes your admin becomes: 


@admin. register (Origin) 
class OriginAdmin (admin.ModelAdmin) : 
list_display = ("name", "hero_count", "villain_count") 


def get_queryset (self, request): 
queryset = super().get queryset (request) 
queryset = queryset.annotate ( 
hero count-Count("hero", distinct=True) , 
villain count-Count("villain", distinct-True), 


) 


return queryset 


(continues on next page) 


(continued from previous page) 


def hero_count (self, obj): 
return obj. hero count 


def villain count(self, obj): 
return obj. villain count 


hero count.admin order field = ' hero count' 
villain, count.admin, order field = ' villain count' 


Here is the admin sorted on hero count 


Select origin to change 


Action: | --------- $ | Go | 0of3 selected 
NAME HERO COUNT ~ VILLAIN COUNT 
India 2 1 
Norse 1 1 

Z) Greece 1 0 

3 origins 


3.4 How to enable filtering on calculated fields? 


You have a Hero admin which looks like this: 


Qadmin.register (Hero) 

class HeroAdmin (admin.ModelAdmin) : 
list display = ("name", "is immortal", "category", "origin", "is very benevolent") 
list filter = ("is immortal", "category", "origin",) 


def is very benevolent (self, obj): 
return obj.benevolence factor > 75 


It has one calculated field is very benevolent, and your admin looks like this 


Select hero to change 
FILTER 
Action: | --------- $ Go 0 of 4 selected 
By is immortal 
7] NAME IS IMMORTAL CATEGORY ORIGIN IS VERY BENEVOLENT " 
7) Thor o God Norse True Yes 
No 
^] Achilles o Demi God Greece False 
^7) Vishnu © God India True By category 
All 
© Krishna o Avatar India False God 
Avatar 
4 Heroes 
Demi God 
By origin 
All 
India 
Greece 
Norse 


You have added filtering on the fields which come from the models, but you also want to add filtering on the calculated 
field. To do this, you will need to subclass SimpleListFilter like this: 


class IsVeryBenevolentFilter (admin.SimpleListFilter): 
title = 'is very benevolent' 
parameter name = 'is very benevolent' 


def lookups(self, request, model admin): 
return ( 
('Yes', 'Yes'), 
(CENO p "No"), 


def queryset (self, request, queryset): 
value = self.value() 
if value == 'Yes': 
return queryset.filter (benevolence_factor__gt=75) 
elif value == 'No': 
return queryset.exclude (benevolence_factor__gt=75) 
return queryset 


And then change your list filter to list filter = ("is immortal", "category", 
"origin", IsVeryBenevolentFilter). 


With this you can filter on the calculated field, and your admin looks like this: 


Select hero to change 


Action: | --------- 4 | Go | 0of2 selected FILTER 


= By is immortal 
O NAME IS IMMORTAL CATEGORY ORIGIN IS VERY BENEVOLENT 


All 
O Thor o God Norse True 


O Vishnu [^] God India True No 


2 Heroes By category 


All 

God 
Avatar 
Demi God 


By origin 
All 


India 
Greece 


Norse 


By is_very_benevolent 


All 
Yes 
No 


3.5 How to show “on” or “off” icons for calculated boolean fields? 


In the previous chapter, How to enable filtering on calculated fields? you added a boolean field.: 


def is_very_benevolent (self, obj): 
return obj.benevolence_factor > 75 


Which looks like this 


Select hero to change 


Action: | --------- $ | Go | Oof 2 selected FILTER 


> By is immortal 
[ NAME IS IMMORTAL CATEGORY ORIGIN IS VERY BENEVOLENT 


All 
Thor o God Norse True 


Vishnu © God India True No 


2 Heroes By category 


All 

God 
Avatar 
Demi God 


By origin 
All 


India 
Greece 


Norse 


By is_very_benevolent 


All 


The is_very_benevolent field shows the string True and False, unlike the builtin BooleanFields which show an 
on and off indicator. To fix this, you add a boolean attribute on your method. You final modeladmin looks like this: 


@admin. register (Hero) 

class HeroAdmin (admin.ModelAdmin) : 
list_display = ("name", "is_immortal", "category", "origin", "is_very_benevolent") 
list_filter = ("is_immortal", "category", "origin", IsVeryBenevolentFilter) 


def is_very_benevolent (self, obj): 
return obj.benevolence_factor > 75 


is very benevolent.boolean = True 


And your admin looks like this 


Action: | --------- $| Go | 0of4 selected 


NAME IS IMMORTAL CATEGORY ORIGIN IS VERY BENEVOLENT 
Thor o God Norse © 

^] Achilles o Demi God Greece o 

-] Vishnu © God India © 

_) Krishna o Avatar India o 

4 Heroes 


4 Bulk and custom actions 


4.1 How to add additional actions in Django admin? 


Django admin allows you to add additional actions which allow you to do bulk actions. You have been asked to add 
an action which will mark multiple Hero s as immortal. 


You can do this by adding the action as method to ModelAdmin and adding the method as a string to actions 


actions = ["mark immortal"] 


def mark immortal(self, request, queryset): 
queryset.update(is immortal-True) 


4.2 How to export CSV from Django admin? 


You have been asked to add ability to export Hero and Villain from the admin. There are a number of third party 
apps which allow doing this, but its quite easy without adding another dependency. You will add an admin action to 
HeroAdmin and VillanAdmin. 


An admin action always has this signature def admin action (modeladmin, request, queryset):, 
alternatively you can add it directly as a method on the ModelAdmin like this: 


class SomeModelAdmin (admin.ModelAdmin) : 


def admin action(self, request, queryset): 


To add csv export to HeroAdmin you can do something like this: 


actions = ["export as csv"] 


def export as csv(self, request, queryset): 
pass 


(continues on next page) 


(continued from previous page) 


export_as_csv.short_description = "Export Selected" 


This adds an action called export selected, which looks like this: 


Select hero to change 


Delete selected Heroes 


^ w Export Selected IS IMMORTAL 
^] Thor o 

^] Achilles [x] 

^] Vishnu © 

^] Krishna o 

4 Heroes 


You will then change the export, as. csv to this: 


import csv 
from django.http import HttpResponse 


def export as csv(self, request, queryset): 


meta - self.model. meta 


field names = [field.name for field in meta.fields] 

response - HttpResponse(content type-'text/csv') 
response['Content-Disposition'] = 'attachment; filename={}.csv'.format (meta) 
writer = csv.writer (response) 


writer.writerow(field names) 
for obj in queryset: 
row = writer.writerow([getattr(obj, field) for field in field names]) 


return response 


This exports all of the selected rows. If you notice, export as csv doens't have anything specific to Hero, so 
you can extract the method to a mixin. 


With the changes, your code looks like this: 


class ExportCsvMixin: 
def export_as_csv(self, request, queryset): 


meta = self.model._meta 


field_names = [field.name for field in meta.fields] 

response = HttpResponse(content type-'text/csv') 
response['Content-Disposition'] = ‘attachment; filename={/}.csv'.format (meta) 
writer = csv.writer (response) 


writer.writerow(field_names) 
for obj in queryset: 
row = writer.writerow([getattr(obj, field) for field in field names]) 


return response 


export_as_csv.short_description = "Export Selected" 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


list display = ("name", "is immortal", "category", "origin", "is very benevolent") 
list filter - ("is immortal", "category", "origin", IsVeryBenevolentFilter) 
actions = ["export as. csv"] 


Qadmin.register(Villain) 

class VillainAdmin (admin.ModelAdmin, ExportCsvMixin): 
list display = ("name", "category", "origin") 
actions = ["export as, csv"] 


You can add such an export to other models by subclassing from ExportCsvMixin 


4.3 How to remove the delete selected action in Django admin? 
By default Django adds a Delete Selected action to the listview page. You have been asked to remove the action from 
the Hero admin. 


The method ModelAdmin.get actions returns the actions shown. By overriding this method, to remove 
delete selected We can remove it form the dropdown. Your code looks like this with the changes.: 


def get actions(self, request): 
actions = super().get actions (request) 
if 'delete selected' in actions: 
del actions['delete selected'] 
return actions 


And your admin looks like this 


Select hero to change 


Delete selected Heroes 


^| wj Export Selected IS IMMORTAL 
Thor 
Achilles o 
Vishnu © 
Krishna o 
4 Heroes 


You should also read How to remove the ‘Add’/ Delete’ button for a model?. 


4.4 How to add Custom Action Buttons (not actions) to Django Admin list page? 
UMSRA has decided that given sufficient kryptonite, all Heroes are mortal. However, they want to be able to change 
their mind and say all heroes are immortal. 


You have been asked to add two buttons - One which makes all heroes mortal, and one which makes all immortal. 
Since it affects all heroes irrespective of the selection, this needs to be a separate button, not an action dropdown. 


First, we will change the template on the HeroAdmin so we can add two buttons.: 


Qadmin.register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 
change list template - "entities/heroes changelist.html" 


Then we will override the get. urls, and add the set. immortal and set mortal methods on the model 
admin. They will serve as the two view methods.: 


def get urls(self): 
urls = super().get urls() 
my urls - [ 
path('immortal/', self.set immortal), 
path('mortal/', self.set mortal), 
] 


return my_urls + urls 


def set_immortal(self, request): 
self.model.objects.all().update(is immortal-True) 


(continues on next page) 


(continued from previous page) 


self.message_user(request, "All heroes are now immortal") 
return HttpResponseRedirect ("../") 


def set_mortal(self, request): 
self.model.objects.all().update(is immortal-False) 


Self.message user(request, "All heroes are now mortal") 
return HttpResponseRedirect("../") 


Finally, we create the entities/heroes changelist.html template by extending the admin/ 
change list.html. 


{% extends 'admin/change list.html' £) 


($ block object-tools 3%} 
«div» 
«form action-"immortal/" method="POST"> 
{S csrf token %} 
«button type-"submit"»Make Immortal</button> 
«/form» 
«form action-"mortal/" method="POST"> 
{S csrf token %} 
«button type-"submit"»Make Mortal</button> 
</form> 
</div> 
<br /> 
{{ block.super }} 
(5$ endblock %} 


Select hero to change 


Make Immortal 


Make Mortal 


Action: | --------- *|| Go | Oof 5 selected 


And after using the make_mortal action, the Heroes are all mortal and you see this message. 


© Allheroes are now mortal 


Select hero to change 


Make Immortal 


Make Mortal 

Action: | --------- $|| Go | Oof 5 selected 

^] NAME IS IMMORTAL CATEGORY ORIGIN 
^] Zeus o God Greece 
^] Thor o God Norse 

-] Achilles o Demi God Greece 
^] Vishnu o God India 

© Krishna o Avatar India 

5 Heroes 


4.5 How to import CSV using Django admin? 


IS VERY BENEVOLENT 


o O O 8 


You have been asked to allow csv imports on the Hero admin. You will do this by adding a link to the Hero changelist 
page, which will take to a page with an upload form. You will write a handler for the POST action to create the objects 


from the csv.: 


class CsvlImportForm(forms.Form): 
csv file - forms.FileField() 


Qadmin.register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


change list template = "entities/heroes changelist.html" 


def get urls(self): 
urls = super().get urls() 
my urls = [ 


path('import-csv/', self.import csv), 
] 


return my urls + urls 


def import csv(self, request): 


if request.method == "POST": 
csv file - request.FILES["csv file"] 
reader = csv.reader (csv file) 
# Create Hero objects from passed in data 
# 


self.message_user (request, "Your csv file has been imported") 


(continues on next page) 


(continued from previous page) 


return redirect("..") 
form = CsvImportForm() 
payload = {"form": form} 
return render ( 
request, "admin/csv_form.html", payload 


Then you create the entities/heroes changelist.html template, by overriding the admin/ 
change list.html template like this.: 


{% extends 'admin/change list.html' %} 


($ block object-tools %} 
<a href-"import-csv/"»Import CSV</a> 
<br /> 
{{ block.super }} 

{S endblock %} 


Finally you create the csv_form. html like this.: 


{% extends 'admin/base.html' %} 


{5 block content %} 


<div> 
<form action-"." method-"POST" enctype-"multipart/form-data"» 
{{ form.as p }} 
{S csrf token %} 
<button type-"submit"»Upload CSV</button> 
«/ form» 
«/div» 
«br /» 


{5 endblock %} 


With these changes, you get a link on the Hero changelist page. 


Home > Entities » Heroes 


© Your csv file has been imported 


Select hero to change 


Import CSV 
«2018 February 21 February 22 FILTER 


Action: | --------- + Go 0 of 7 selected By is immortal 
All 
O NAME IS IMMORTAL CATEGORY ORIGIN IS VERY BENEVOLENT CHILDREN vas 
O Apollo © God Greece © - No 


And the import form apge looks like this. 


Csv file: Choose File No file chosen 


Upload CSV 


5 Permissions 


5.1 How to restrict Django admin to specific users? 
Django admin allows access to users marked as is staff-True. To disable a user from being able to access the 
admin, you should set is staff-False. 


This holds true even if the user is a superuser. is superuser-True. If a non-staff tries to access the admin, they 
see a message like this. 


You are authenticated as shabda, but are not 
authorized to access this page. Would you like to 
login to a different account? 


Username: 


Password: 


5.2 How to restrict access to parts of Django admin? 


You can enable and restrict access to specific parts of Django admin using the permission system. When a model is 
added, by default, Django creates three permissions. add, change and delete 


Admin uses these permissions to decide access for users. For a user with is_superuser=False, and no permis- 


sions, the admin looks like this 


Welcome to UMSRA Researcher Portal 


You don't have permission to edit anything. 


If you add a permission user.user permissions.add(Permission.objects. 
get (codename-"add, hero")), the admin starts looking like this 


Entities administration 


ENTITIES 


Heroes + Add 


You can add more complex logic to restrict access by changing these methods: 


def has add permission(self, request): 


def has change permission(self, request, obj-None): 


def has delete permission(self, request, obj-None): 


def has module permission(self, request): 


5.3 How to allow creating only one object from the admin? 


The UMSRA admin has asked you to limit the number of categories to only one. They want every entity to be of the 
same category. 


You can do this by: 


MAX OBJECTS = 1 


(continues on next page) 


(continued from previous page) 


def has_add_permission(self, request): 
if self.model.objects.count() >= MAX_OBJECTS: 
return False 
return super().has_add_permission (request) 


This would hide the add buton as soon as one object is created. You can set MAX_OBJECTS to any value to ensure 
that larger number of objects can’t be ceated than MAX_OBJECTS. 


5.4 How to remove the 'Add"/ Delete’ button for a model? 


The UMSRA management has added all the Category and Origin objects and wants to disable any further addi- 
tion and deletion. They have asked you to disable ‘Add’ and ‘Delete’ buttons. You can do this by overriding the 
has, add, permission and has delete permission in the Django admin.: 


def has add permission(self, request): 
return False 


def has delete permission(self, request, obj-None): 
return False 


With these changes, the admin looks like this 
—————————— "e —————————)—!Á————À——  /!—12:] 


Entities administration 


ENTITIES 


Categories # Change 
Heroes * Add # Change 
Origins # Change 
Villains * Add # Change 


Note the removed Add buttons. The add and delete buttons also get removed from the detail pages. You can also read 
How to remove the delete selected action in Django admin ?. 


6 Multiple models and inlines 


6.1 How to edit mutiple models from one Django admin? 


To be able to edit multiple objects from one Django admin, you need to use inlines. 


You have the Category model, and you need to add and edit Villain models inside the admin for Category. You 
can do: 


class VillainInline (admin.StackedInline): 
model - Villain 


@admin. register (Category) 
class CategoryAdmin (admin.ModelAdmin) : 


inlines = [VillainInline] 


You can see the form to add and edit Villain inside the Category admin. If the Inline model has alot of fields, 
use StackedInline else use TabularInline. 


Change category HISTORY 


VILLAINS 


Villain: Ravana 


(3j Delete 
Name: Ravana 
Alternative name: 
Origin: Inda $2 
Gender. Male $ 
Description: Primary antagonist in Ramayana 


6.2 How to add One to One relation as admin inline? 


OneToOneFields can be set as inlines in the same way as a FK. However, only one side of the OneToOneField can be 
set as the inline model. 


You have a HeroAcquaintance model which has a One to one relation to hero like this.: 


class HeroAcquaintance (models.Model): 
"Non family contacts of a Hero" 
hero = models.OneToOneField(Hero, on delete-models.CASCAD 


C3 
— 


You can add this as inline to Hero like this: 


class HeroAcquaintanceInline (admin.TabularInline): 
model = HeroAcquaintance 


(continues on next page) 


(continued from previous page) 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


inlines = [HeroAcquaintanceInline] 


Headshot: Choose File No file chosen 
Father. Zeus 4| 95 ^x 
Mother . .  |--------- 4 + 
Spouse: ---———--— H + 


Headshot image: z 


HERO ACQUAINTANCES 


FRIENDS DETRACTORS MAIN ANATAGONISTS DELETE? 
Krishna Krishna Ravana 
Vishnu Vishnu + Fenrir " 
Achilles Achilles 
Thor Thor 


Save and add another Save and continue editing 


6.3 How to add nested inlines in Django admin? 


You have yor models defined like this: 


class Category (models.Model): 


class Hero (models.Model): 
category - models.ForeignKey (Catgeory) 


class HeroAcquaintance (models.Model): 
hero = models.OneToOneField(Hero, on delete-models.CASCADI 


LH 
— 


You want to have one admin page to create Category, Hero and HeroAcquaintance objects. However, Django 
doesn't support nested inline with Foreign Keys or One To One relations which span more than one levels. You have 
a few options, 


You can change the HeroAcquaintance model, so that it has a direct FK to Category, something like this: 


class HeroAcquaintance (models.Model): 
hero = models.OneToOneField(Hero, on delete-models.CASCAD 
category - models.ForeignKey (Category) 


Bi 


def save (self, xargs, *xkwargs): 
self.category = self.hero.category 
super () .save (xargs, *xkwargs) 


Then you can attach HeroAcquaintanceInline to CategoryAdmin, and get a kind of nested inline. 


Alternatively, there are a few third party Django apps which allow nested inline. A quick Github or DjangoPackages 
search will find one which suits your needs and tastes. 


6.4 How to create a single Django admin from two different models? 


Hero has a FK to Category, so you can select a category from Hero admin. If you want to also be able to create 
Category objects from Hero admin, you can change the form for Hero admin, and customise the save model 
behaviour.: 


class HeroForm(forms.ModelForm): 
category name - forms.CharField() 


class Meta: 
model - Hero 
xclude = ["category"] 


Qadmin.register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 
form = HeroForm 


def save_model (self, request, obj, form, change): 


category_name = form.cleaned_data["category_name"] 

category, _ = Category.objects.get_or_create (name=category_name) 
obj.category = category 

super ().save_model (request, obj, form, change) 


With this change, your admin looks like below and has allows creating or updating category from the Hero admin. 


Father: Zeus 7+ e 


Mother swat at at $ + 
Spouse . .— ) .  -------- $ + 
Category name: 


Headshot image: - 


7 Listview Page 


7.1 How to show larger number of rows on listview page? 


You have been asked to increase the number of heroes one can see on a single page to 250. (The default is 100). You 
can do this by: 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


list_per_page = 250 


You can also set it to a smaller value. If we set it to 1 as list_per_page = 1 the admin looks like this. 


Select hero to change 


Action: | --------- s Go | Oof1 selected 
NAME IS IMMORTAL CATEGORY ORIGIN IS VERY BENEVOLENT 
Thor © God Norse © 


1 1243] 4| 4Heroes Show all 


7.2 How to disable django admin pagination? 


If you want to completely disable pagination on a admin listview page, you can do this. 


import sys 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


list_per_page = sys.maxsize 


You can also read How to show larger number of rows on listview page ?. 


7.3 How to add date based filtering in Django admin? 


You can add a date based filtering on any date field by setting the date hierarchy. 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


date hierarchy = 'added on' 


It looks like this: 
«2018 February 19 February 20 


Action: | --------- || Go | Oof 7 selected 


NAME IS IMMORTAL 
Apollo © 

_) Athena 

Zeus 

Thor 

Achilles 


Vishnu 


| 
o O O O QO OQO 


Krishna 


7 Heroes 


CATEGORY 


God 


God 


God 


God 


Demi God 


God 


Avatar 


This can be very costly with a large number of objects. As an alternative, you can subclass SimpleListFilter, 
and allow filtering only on years or the months. 


7.4 How to show many to many or reverse FK fields on listview page? 


For heroes you can track their father using this field: 


father = models.ForeignKey ( 


"self", related_name="children", 


) 


null=True, 


blank-True, on delete-models.Sl 


ET NULL 


You have been asked to show the childeren of each Hero, on the listview page. Hero objects have the children 
reverse FK attribute, but you can't add that to the :code*:/ist. display. You need to add an attribute to ModelAdmin and 
use that in list display. You can do it like this: 


@admin. register (Hero) 


class HeroAdmin (admin.ModelAdmin, 


def children display(self, obj): 


return ", ".join([ 


ExportCsvMixin): 


child.name for child in obj.children.all() 


1) 


children display.short description = "Children" 


You will see a column for children like this: 


Select hero to change 


Make Immortal 
Make Mortal 


Action: | --------- ^! Go 


NAME IS IMMORTAL 
Apollo © 

Athena 
Zeus 
Thor 
Achilles 


Vishnu 


o o0 O 8 O 


Krishna 


7 Heroes 


0 of 7 selected 


CATEGORY 


God 


God 


God 


God 


Demi God 


God 


Avatar 


ORIGIN 


Greece 


Greece 


Greece 


Norse 


Greece 


India 


India 


IS VERY BENEVOLENT 


oe 00 08 8 


CHILDREN 


Athena, Apollo 


You can use the same method for M2M relations as well. You should also read How to get Django admin 


urls for 


specific objects ?. 


8 Changeview Page 


8.1 How to show image from Imagefield in Django admin. 


In your Hero model, you have an image field.: 


headshot = models.ImageField(null=True, blank=True, upload_to="hero_headshots/") 


By default it shows up like this: 


Headshot: Currently: hero headshots/zeus.jpeg ( | Clear 


Change: Choose File No file chosen 


You have been asked to change it to that the actual image also shows up on the change page. You can do it likethis: 


Qadmin.register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


readonly fields = [..., "headshot_image"] 


def headshot image(self, obj): 
return mark safe('«img src-"íurl]" width="{width}" height={height} /»'.format( 
url = obj.headshot.url, 
width-obj.headshot.width, 
height-obj.headshot.height, 
) 


With this change, your imagefield looks like this: 


Headshot: Currently: hero headshots/zeus.jpeg ( ) Clear 


Change: Choose File No file chosen 


Father: - 


Mother. - 


Spouse: - 


Headshot image: 


8.2 How to associate model with current user while saving? 


The Hero model has the following field.: 


added by = models.ForeignKey (settings.AUTH USER MODEL, 
null-True, blank-True, on delete-models.SET NULL) 


You want the added, by field to be automatically set to current user whenever object is created from admin. You can 
do this.: 


def save model(self, request, obj, form, change): 
if not obj.pk: 
# Only set added by during the first save. 
obj.added by = request.user 
super().save model(request, obj, form, change) 


If instead you wanted to always save the current user, you can do.: 


def save_model (self, request, obj, form, change): 
obj.added_by = request.user 
super().save_model (request, obj, form, change) 


If you also want to hide the added_by field to not show up on the change form, you can do.: 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


xclude = ['added by',] 


8.3 How to mark a field as readonly in admin? 


UMSRA has temporarily decided to stop tracking the family trees of mythological entities. You have been asked to 
make the father, mother and spouse fields readonly. 


You can do this by: 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


readonly_fields = ["father", "mother", "spouse"] 


Your create form looks like this: 


Is immortal 


Benevolence factor. 


How benevolent this hero is? 


Arbitrariness factor. 


How arbitrary this hero is? 


Father: - 


Mother: - 


Spouse: - 


8.4 How to show an uneditable field in admin? 


If you have a field with editable-False in your model, that field, by default, is hidden in the change page. This 
also happens with any field marked as auto. now or auto. now. add, because that sets the editable-False on 
these fields. 


If you want these fields to show up on the change page, you can add them to readonly fields. 


Qadmin.register(Villain) 
class VillainAdmin (admin.ModelAdmin, ExportCsvMixin): 


readonly fields = ["added on"] 


With this change the Villain admin looks like this: 


Is unique 

Count: 1 

Added on: Feb. 19, 2018 
Delete 


8.5 How to make a field editable while creating, but read only in existing objects? 


You need to make the name and category read only once a Hero is created. However duing the first write the 
fields needs to be editable. 


You can do this by overriding get. readonly fields method, like this: 


def get readonly fields(self, request, obj-None): 
if obj: 


return ["name", "category"] 
else: 
return [] 


obj is None during the object creation, but set to the object being edited during an edit. 


8.6 How to filter FK dropdown values in django admin? 


Your Hero model has a FK to Category. So all category objects will show in the admin dropdown for 
category. If instead, you wanted to see only a subset, Django allows you to customize that by overriding 
formfield_for_foreignkey: 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


def formfield for foreignkey(self, db field, request, **xkwargs): 


if db field.name -- "category": 
kwargs["queryset"] = Category.objects.filter(name  in-['God', 'Demi God']) 
return super().formfield for foreignkey(db field, request, **xkwargs) 


Change hero 


Name: Apollo 


Alternative name: 


Category: |v God 


Origin: Greece + & 


8.7 How to manage a model with a FK with a large number of objects? 


You can create a large number of categories like this: 


categories = [Category(**{"name": "cat-í]".format(i))) for i in range(100000) ] 
Category.objects.bulk_create (categories) 


Now as Category has more than 100000 objects, when you go to the Hero admin, it will have category dropdown 
with 100000 selections. This will make the page both slow and the dropdown hard to use. 


You can change how admin handles it by setting the raw_id_fields: 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


raw_id_fields = ["category"] 


This change the Hero admin to look like: 


Change hero 


Name: Apollo E) 
Alternative name: 


Category: 1 Q God 
Add the popup looks like this 
cat-99905 
cat-99904 
cat-99903 
cat-99902 
cat-99901 


cat-99900 


1 BHB EHE 10004 categories 


8.8 How to change ForeignKey display text in dropdowns? 
Hero has a FK to Catgeory. In the dropdown, rather than just the name, you want to show the text "Category: 
<name>”. 


You can change the __str___ method on Category, but you only want this change in the admin. You can do this 
by creating a subclassing forms .ModelChoiceField with acustom 1abel from instance. 


class CategoryChoiceField (forms .ModelChoiceField) : 
def label_from_instance(self, obj): 
return "Category: {/}".format (obj.name) 


You can then override formfield_for_foreignkey to use this field type for category.: 


def formfield for foreignkey(self, db field, request, *xkwargs): 


if db field.name == 'category': 
return CategoryChoiceField(queryset-Category.objects.all()) 
return super().formfield for foreignkey (db field, request, **kwargs) 


Your admin look like this. 


Name: Apollo 


Alternative name: 


Category 
Category: Avatar 
Category: Demi God 

Origin: Category: Half God 


«<> 


Gender. Male 


8.9 How to add a custom button to Django change view page? 


Villain has a field called is_unique: 


class Villain(Entity): 


is_unique = models.BooleanField(default=True) 


You want to add a button on Villain change form page called “Make Unique", which make this Villain unique. Any 
other villain with the same name should be deleted. 


You start by extending the change_form to add a new button.: 


{% extends 'admin/change form.html' %} 


{5 block submit buttons bottom £) 
(( block.super }} 
«div class-"submit-row"» 


<input type="submit" value-"Make Unique" name-" make-unique"» 
«/div» 
{5 endblock %} 


Then you can override response change and connect your template to the VillainAdmin.: 


Qadmin.register(Villain) 
class VillainAdmin(admin.ModelAdmin, ExportCsvMixin): 


change form template - "entities/villain changeform.html" 


(continues on next page) 


(continued from previous page) 


def response_change(self, request, obj): 
if "_make-unique" in request.POST: 
matching names except this = self.get_queryset (request) . filter (name-obj. 
name) .exclude (pk=obj.id) 
matching names except this.delete() 
obj.is unique - True 


obj.save() 
self.message user(request, "This villain is now unique") 
return HttpResponseRedirect(".") 

return super().response change (request, obj) 


This is how your admin looks now. 


Malevolence factor. 70 


How malevolent this villain is? 


Power factor. 40 


How powerful this villain is? 


Is unique 
Count: 1 
Added on: Feb. 23, 2018 


Save and add another Save and continue editing 


9 Misc 


9.1 How to get Django admin urls for specific objects? 


You have a children column displaying the names of each heroes’ children. You have been asked to link each children 
to the change page. You can do it like this.: 


@admin. register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 


(continues on next page) 


(continued from previous page) 


def children_display(self, obj): 


display_text = ", ".join([ 
"<a href={}>{}</a>".format ( 
reverse ('admin: {}_{}_change'.format (obj._meta.app_label, obj._ 


meta.model name), 


args- (child.pk,)), 
child.name) 
for child in obj.children.all() 
1) 
if display text: 
return mark safe(display text) 
return "-" 


The reverse ('admin: {}_{}_change'.format (obj._meta.app_label, obj. meta. 
model name), args=(child.pk, ) ), gives the change url for an object. 


The other options are 


e Delete: reverse('admin:(). (). delete'.format(0obj. meta.app label, obj. meta. 
model name), args-(child.pk,)) 


e History: reverse('admin:() () history'.format(0obj. meta.app label, obj. meta. 
model name), args-(child.pk,)) 


9.2 How to add a model twice to Django admin? 


You need to add the Hero model twice to the admin, one as a regular admin area, and one as read only admin. (Some 
user will potentially see only the read only admin.) 


If you have try to register the same model twice: 


admin.site.register (Hero) 
admin.site.register (Hero) 


you will get an error like this: 


raise AlreadyRegistered('The model $s is already registered' $ model. name ) 


THe solution is to sublass the Hero model as a ProxyModel.: 


# In models.py 
class HeroProxy (Hero): 


class Meta: 
proxy 


True 


# In admin.py 
Qadmin.register (Hero) 
class HeroAdmin(admin.ModelAdmin, ExportCsvMixin): 
list display = ("name", "is immortal", "category", "origin", "is very benevolent") 


@admin. register (HeroProxy) 


(continues on next page) 


(continued from previous page) 


class HeroProxyAdmin (admin.ModelAdmin) : 
readonly_fields = ("name", "is_immortal", "category", "origin", 


-) 


9.3 How to override save behaviour for Django admin? 


ModelAdmin has a save model method, which is used for creating and updating model objects. By overriding 
this, you can customize the save behaviour for admin. 


The Hero model has the following field.: 


added by = models.Foreignkey (settings.AUTH USER MODEL, 
null-True, blank-True, on delete-models.SET NULL) 


If you want to always save the current user whenever the Hero is updated, you can do.: 


def save model(self, request, obj, form, change): 
obj.added by = request.user 
super().save model(request, obj, form, change) 


9.4 How to add a database view to Django admin? 


You have a database view, created as this: 


create view entities entity as 
Select id, name from entities hero 
union 
select 10000+id as id, name from entities villain 


It has all the names from Hero and Villain. The id's for Villain are set to 10000+id as id because we don't 
intend to cross 10000 Heroes: 


sqlite> select x from entities entity; 
Krishna 

Vishnu 

Achilles 

Thor 

Zeus 

Athena 

7|Apollo 

10001|Ravana 

10002|Fenrir 


O01 WN EF 


Then you add a managed=F alse model: 


class AllEntity (models.Model): 
name = models.CharField(max length-100) 


class Meta: 
managed - False 
db table = "entities entity" 


And add it to admin.: 


@admin. register (AllEntity) 
class AllEntiryAdmin (admin.ModelAdmin) : 
list_display = ("id", "name") 


And your admin looks like this 


Action: | --------- + Go 0 of 9 selected 
) 1 NAME 
-) 310002 Fenrir 
—) 10001 Ravana 
7 7 Apollo 
9 |. Athena 
`J 5 Zeus 
© 4 Thor 
7 3 Achilles 
B Vishnu 
J 1 Krishna 
9 all entitys 


9.5 How to set ordering of Apps and models in Django admin dashboard. 
Django, by default, orders the models in admin alphabetically. So the order of models in Event admin is Epic, 
EventHero, EventVillain, Event 
Instead you want the order to be 
* EventHero, EventVillain, Epic then event. 


The template used to render the admin index page is admin/index. html] and the view function is ModelAdmin. 
index. 


def index(self, request, xtra context-None): 


mmm 


Display the main admin index page, which lists all of the installed 


apps that have been registered in this site. 
nmi 


app list = self.get app list (request) 


context = { 
**self.each context (request), 
'title': self.index title, 


'app list': app list, 
**(extra context or {}), 


request.current app = self.name 


return TemplateResponse(request, self.index template or 
'admin/index.html', context) 


The method get. app. list, set the order of the models.: 


def get app list(self, request): 


"mmm 


Return a sorted list of all the installed apps that have been 


registered in this site. 
nni 


app dict = self. build app dict (request) 


# Sort the apps alphabetically. 
app list = sorted(app dict.values(), key-lambda x: x['name'].lower()) 


# Sort the models alphabetically within each app. 
for app in app list: 
app['modeis'].sort(key-lambda x: x['name']) 


return app list 


So to set the order we override get. app. list as: 


class EventAdminSite (AdminSite): 
def get app list(self, request): 

n mm 
Return a sorted list of all the installed apps that have been 
registered in this site. 
n mm 
ordering = { 

"Event heros": 1, 

"Event Villains": 2, 

"Epics": 3, 

"Events": 4 


app dict = self. build app dict (request) 

# a.sort(key-lambda x: b.index(x[0])) 

# Sort the apps alphabetically. 

app list = sorted(app dict.values(), key=lambda x: x['name'].lower()) 


$ Sort the models alphabetically within each app. 
for app in app list: 


(continues on next page) 


(continued from previous page) 


app['models'].sort (key=lambda x: 


return app_list 


ordering[x['name']]) 


The code app['models'].sort(key-lambda x: 


Your app now looks like this. 


Welcome to UMSRA Researcher Events Portal 


ordering[x['name']]) sets the fixed ordering. 


EVENTS 


Event heros 
Event villains 
Epics 


Events 


10 Indices and tables 


10.1 Models used in this book 
App entities 


'The models are: 


+ Add 
+ Add 
+ Add 


+ Add 


# Change 
# Change 
# Change 


# Change 


class Category (models.Model): 
name = models.CharField(max length-100) 


class Meta: 
verbose name plural = "Categories" 


def str (self): 
return self.name 


class Origin (models.Model): 
name = models.CharField(max length-100) 


def str (self): 
return self.name 


(continues on next page) 


(continued from previous page) 


class Entity (models.Model): 


GENDER MALE - "Male" 
GENDER FEMALE = "Female" 
GENDER OTHERS - "Others/Unknown" 


name = models.CharField(max length-100) 
alternative name - models.CharField( 


max length-100, null-True, blank-True 


Ei 


category = 
origin = models.ForeignKey (Origin, 
gender = models.CharField ( 
max_length=100, 
choices= ( 
(GENDER_MALE, GENDER_MALE), 
(GENDER FEMALE, GENDER FEMALE), 
(GENDER OTHERS, GENDER OTHERS), 


models.ForeignKey (Category, on delete-models.CASCAD 
on delete-models.CASCADE) 


) 
description - models.TextField() 


def str (self): 
return self.name 


class Meta: 


abstract - True 
class Hero (Entity): 
class Meta: 
verbose name plural = "Heroes" 


is immortal - models.BooleanField(default-True) 


benevolence factor = models.PositiveSmallIntegerField( 
help text-"How benevolent this hero is?" 


) 

arbitrariness factor = models.PositiveSmallIntegerField( 
help text-"How arbitrary this hero is?" 

) 

# relationships 

father = models.ForeignKey( 


"self", related name-"-«", null-True, blank-True, on delete-models.SET NULL 
) 
mother = models.ForeignKey( 

"self", related_name="+", null=True, blank=True, on_delete=models.SET_NULL 
) 
spouse = models.ForeignKey( 

"self", related_name="+", null=True, blank=True, on_delete=models.SET_NULL 


class Villain(Entity): 


(continues on next page) 


(continued from previous page) 


is immortal = models.BooleanField(default-False) 


malevolence factor = models.PositiveSmallIntegerField( 
help text-"How malevolent this villain is?" 

) 

power factor = models.PositiveSmallIntegerField ( 
help_text="How powerful this villain is?" 

) 

is_unique = models.BooleanField(default=True) 

count = models.PositiveSmalllIntegerField(default-1) 


App events 


The models are: 


class Epic (models.Model): 
name = models.CharField(max_length=255) 
participating_heroes = models.ManyToManyField (Hero) 
participating_villains = models.ManyToManyField(Villain) 


class Event (models.Model): 
pic = models.ForeignKkKey (Epic, on delete-models.CASCADE 
details = models.TextField() 
years, ago = models.PositiveIntegerField() 


class EventHero (models.Model): 
vent = models.ForeignKey (Event, on delete-models.CASCAD 
hero = models.ForeignKey (Hero, on delete-models.CASCADE) 
is primary - models.BooleanField() 


LH 


class EventVillain(models.Model): 
vent = models.ForeignKey (Event, on delete-models.CASCADE 
hero = models.ForeignKey(Villain, on delete-models.CASCAD 
is primary - models.BooleanField() 


Ei 


* genindex 


* modindex 


